home *** CD-ROM | disk | FTP | other *** search
/ Chip: Hang es video / CHIP_ZENESZERKESZTO_2005.ISO / audio_1 / psycle / Psycle / Skins / how to skin psycle.txt next >
Text File  |  2002-12-26  |  6KB  |  115 lines
  1. A quick doc on skinning psycle 
  2. ------------------------------
  3.  
  4. 1) Preface, What's skinnable?
  5.  
  6.     There are two things skinnable right now, the Machine boxes, and the Pattern headers.
  7.     At a later time we will probably allow skinning of knobs (native machines' parameters)
  8.  
  9.     These parts support different sizes and also transparency.
  10.  
  11. 2) What do I need in order to skin?
  12.  
  13.     You need to make four files, two for graphics, and two for image information.
  14.     These files are the folowing:
  15.  
  16.         your_machine_graphics_name.bmp
  17.         your_header_graphics_name.bmp
  18.         your_machine_graphics_info_.psm
  19.         your_header_graphics_info.psh
  20.  
  21.     You can put them in subdirectories if you like, but they have NOT to contain dots "."
  22.     (this limitation might be removed at a later time).
  23.  
  24.     Also, note that the .psm and the .psh files need to be on the same directory than the 
  25.     .bmp's. If you put them separated, they won't be loaded.
  26.  
  27. 3) How do I make the files?
  28.  
  29.     The best way to start is getting one skin and modifying it. Once you understand
  30.     how everything works, you might be confident on starting from your own work.
  31.  
  32.     Notes for graphics:
  33.  
  34.         You can make them the way you want, with the bitdepth appropiated. Support for other
  35.         fileformats than .bmp are not planned (they would require specific loaders).
  36.  
  37.     Notes for info files:
  38.  
  39.     mach.psm (machines info)
  40.     ------------------------
  41.  
  42.     The following values tell psycle how your bitmap file is formatted (this is, where are the 
  43.     graphics and which size do they have.
  44.     Coords are top, left, width height
  45.  
  46.  
  47.     "master_source"=0,153,189,22         <---- GraphicBox for master.
  48.     "generator_source"=0,6,195,112       <---- GraphicBox for the Generator machines
  49.     "generator_vu0_source"=0,0,4,6       <---- the highlighted vu graphic, the Width also tells the VU's block size.
  50.     "generator_vu_peak_source"=157,0,4,6 <---- the "peak" vu graphic (which is left when the vu goes down)
  51.     "generator_pan_source"=196,39,8,9    <---- the pan handle graphic 
  52.     "generator_mute_source"=233,0,28,27  <---- the mute highlighted graphic 
  53.     "generator_solo_source"=195,0,37,38  <---- the solo highlighted graphic 
  54.  
  55.     "effect_source"=0,118,227,32        <----- GraphicBox for Effect machines
  56.     "effect_vu0_source"=0,150,2,3       <----- the highlighted vu graphic, the Width also tells the VU's block size.
  57.     "effect_vu_peak_source"=41,150,2,3  <----- the chunk of the vu that is left when the vu goes down
  58.     "effect_pan_source"=196,39,8,9      <----- the pan handle graphic
  59.     "effect_mute_source"=197,51,19,11   <----- the mute highlighted graphic
  60.     "effect_bypass_source"=221,51,21,10 <----- the bypass highlighted graphic
  61.  
  62.     If you do not want a vu on either machine you may set the height of the vu0_source to 0.
  63.  
  64.  
  65.     The following values tell psycle how has it to draw the different objects.
  66.     Here, the coords are relative to the top left corner of the source graphic.
  67.      (i.e. the top left of the gen/fx graphic is 0,0 .. *not* the top left of mach.bmp)
  68.  
  69.  
  70.     "generator_vu_dest"=19,44,156 <---- top, left, width coords of the whole vumeter.
  71.     "generator_pan_dest"=90,67,76 <---- top, left, width coords of the pan. subtract the width of the pan graphic from the total width.
  72.     "generator_mute_dest"=51,68 <---- top, left coords of the mute button
  73.     "generator_solo_dest"=11,62 <----top,left coords of the solo button
  74.     "generator_name_dest"=16,20 <---- top,left cords of the machine text
  75.  
  76.     "effect_vu_dest"=18,9,40    <---- top, left and width coords of the whole vumeter
  77.     "effect_pan_dest"=117,20,71 <---- top, left and width coords of the pan. subtract the width of the pan graphic from the total width.
  78.     "effect_mute_dest"=173,5    <---- top, left coords of the mute button
  79.     "effect_bypass_dest"=197,5  <----top,left coords of the bypass button
  80.     "effect_name_dest"=62,4     <---- top,left cords of the machine text
  81.  
  82.     "transparency"=0000ff00  <---- RGB value of the colour that is to be used as transparency.
  83.                     Leave this value out if your skin has no tranparency so that psycle can use the faster opaque mode renderer
  84.  
  85.  
  86.     head.psh (headers info)
  87.     -----------------------
  88.  
  89.     The following values tell psycle how your bitmap file is formatted (this is, where are the 
  90.     graphics and which size do they have.
  91.     Coords are top, left, width height
  92.  
  93.     "background_source"=0,0,106,16 <---- Background graphic for the header.
  94.     "number_0_source"=0,16,7,12    <---- graphic for the number 0. The others have to follow as "123456789" and have the same size.
  95.     "record_on_source"=70,16,9,9   <---- hihlighted record on button
  96.     "mute_on_source"=79,16,9,9     <---- highlighted mute
  97.     "solo_on_source"=88,16,9,9     <---- highlighted solo
  98.  
  99.     If you do not want any track numbers then make the height of the numbers 0.
  100.  
  101.     The following values tell psycle how has to draw the different objects.
  102.     Here, the coords are relative to the top left corner of the source graphic.
  103.      (i.e. the top left of the gen/fx graphic is 0,0 .. *not* the top left of head.bmp)
  104.  
  105.  
  106.     "digit_x0_dest"=10,2        <---- Position for the left digit
  107.     "digit_0x_dest"=17,2        <---- position for the right digit
  108.     "record_on_dest"=40,4        <---- position for the record button
  109.     "mute_on_dest"=63,4        <---- position for the mute button
  110.     "solo_on_dest"=85,4        <---- position for the solo button
  111.  
  112.     "transparency"=0000ff00  <---- RGB value of the colour that is to be used as transparency.
  113.                     Leave this value out if your skin has no tranparency so that psycle can use the faster opaque mode renderer
  114.  
  115.